マルペイDocs

PayPal決済とは

PayPal決済は、世界で3億人以上のユーザーが利用し、2400万以上のお店で導入されている、便利で安全な決済サービスです。 お客様はPayPalアカウントを開設しクレジットカード情報や銀行口座情報を登録して、IDとパスワードで決済します。PayPalに登録した情報は加盟店様が保持する必要がないので、お客様・加盟店様双方にとって安心です。

処理フロー説明

1. 加盟店様サイトで申込開始（お客様→加盟店様）
2. 当サービスのAPI呼び出し（加盟店様→当サービス）
3. 決済申込処理（当サービス→PayPal）
4. 決済申込結果の通知（PayPal→当サービス）
5. 認証情報（URL）発行（当サービス→加盟店様）
6. PayPalログイン画面表示（加盟店様→お客様）
7. 決済（お客様→PayPal）
8. 決済完了通知（PayPal→当サービス）
9. 決済完了通知（当サービス→加盟店様）
   ※結果通知のみ
10. 商品/サービス提供
11. 入金（PayPal→加盟店様）

取引状態

取引状態		説明
未決済	UNPROCESSED	決済が完了していない状態 （決済がエラーとなった、またはお客様がご注文途中に離脱が主な原因）
要求成功	REQSUCCESS	決済が正常に完了し、お支払い準備が整った状態
仮売上	AUTH	決済が正常に完了し、アカウントより金額を確保した状態
実売上	SALES	仮売上後に、売上確定した状態（お客様への請求が発生）
即時売上	CAPTURE	決済が正常に完了し、売上確定した状態（お客様への請求が発生）
キャンセル	CANCEL	実売上、即時売上をキャンセルした状態
仮売上取消	AUTH_CANCEL	仮売上をキャンセルした状態
決済失敗	PAYFAIL	取引に対して、PayPal管理画面上での操作にてキャンセル等の変更を行った際に異常が発生して決済が無効となってしまった状態
期限切れ	EXPIRED	お客様が期限までに入金手続きを行わず取引が無効となった状態

取引状態遷移

各操作を行った際の取引状態の遷移です。
「－」は、該当する結果、もしくは操作がないことを表しています。

操作	操作結果	操作前の状態	操作後の状態
取引登録	-	-	未決済
決済実行	成功	未決済	要求成功
	失敗		未決済
PayPal上での認証、支払操作完了後の決済処理	成功	要求成功	仮売上／即時売上
	失敗		決済失敗
決済失敗後、PayPal側で審査後のステータス変更（※）	問題なし	決済失敗	即時売上／実売上
	問題あり		決済失敗
お客様がPayPal上の認証、支払操作画面でキャンセル	－	要求成功	決済失敗
キャンセル	成功	即時売上／実売上	キャンセル
	失敗		仮売上／決済失敗
実売上	成功	仮売上	実売上
	失敗		仮売上／決済失敗
仮売上取消	成功	仮売上	仮売上取消
	失敗		仮売上
支払操作が未完了で支払期限切れ	－	要求成功／決済開始	期限切れ

取引状態における可能操作

取引状態	取引登録	決済実行	支払手続き開始IFの呼び出し	キャンセル	仮売上取消	実売上
未決済	-	○	-	-	-	-
要求成功	-	-	○	-	-	-
仮売上	-	-	-	-	○	○
実売上	-	-	-	○	-	-
即時売上	-	-	-	○	-	-
キャンセル	-	-	-	-	-	-
仮売上取消	-	-	-	-	-	-
決済失敗	-	-	-	-	-	-
期限切れ	-	-	-	-	-	-

接続方式別の対応状況

接続方式	対応状況
プロトコルタイプ	○
モジュールタイプ	○
リンクタイプPlus	-

注意事項

内容	説明
利用可能な決済金額	日本円1,000,000円相当 外国通貨での取引は、その時点の為替レートで1,000,000円相当までが上限です。利用可能な通貨は下記URLからご確認ください。 https://www.paypal.com/jp/webapps/mpp/support/currency
フィーチャーフォンを使用しての決済処理	不可
決済実行から支払操作を完了するまでの有効時間	加盟店様によって異なるため詳細はPayPalにお問い合わせください。
決済完了、取消完了後にPayPalからお客様へ送信されるメールの内容	変更不可
仮売上から実売上に変更可能な期間	29日 処理日時を基準とします。4日以降はPayPal側でエラーになる可能性があります。
仮売上のキャンセルが可能な期間	29日 処理日時を基準とします。
実売上・即時売上のキャンセルが可能な期間	180日 処理日時を基準とします。期限を超過した場合はエラーとなりキャンセルできません。
売り手保護制度の有効性について	連携した配送先情報は、商品が届いていない等、「トラブルが発生」する時の異議・チャージバックケースなどに加盟店様の反証材料として利用するものです。配送先情報を入力した決済が成功したからといって、売り手保護が有効になっているかは当サービスでは保証できません。売り手保護制度に関してはPaypalサポートへお問い合せください。
本ドキュメント記載の各種PayPalドキュメントについて	本ドキュメントに記載している各種PayPalドキュメントについて、URLや内容が予告無く変更になる場合があります。リンクにアクセスできない等発生した場合には、弊社カスタマーセンターまでお問い合わせください。

ロゴについて

必ずロゴマーク利用ガイドラインをご確認の上ご利用ください。
下記ウェブサイトからダウンロードしてください。

https://www.paypal.com/jp/webapps/mpp/developer/logos-buttons/download

API許可設定手順

PayPal決済をご利用される際、あらかじめPayPal管理画面にてAPI許可設定が必要です。

1. アカウント設定左メニューの「アカウントへのアクセス」>「APIアクセス」をクリック

2. PayPal API >「API許可を与える」をクリック

3. 新しいサードパーティへの許可を追加する>サードパーティのユーザ名に「 paypal_api2.gmo-pg.com」を入力し「検索する」をクリック

4. 新しいサードパーティへの許可を追加する>許可できる項目の以下7項目をチェックし「登録」をクリック
   ※決済エラー/不整合が発生が発生してしまうため、チェック項目を正しく設定されているかご確認ください
   

複数通貨PayPal管理画面設定手順

日本円以外の通貨による決済を行う場合、あらかじめPayPal管理画面にて設定が必要です。

指定した通貨以外での支払い受け取り設定の確認

1. PayPal管理画面にログイン
2. 画面右上の事業者名から「アカウント設定」を選択
3. 「支払い設定」を選択
4. 「支払い受取りを拒否する」の右の「更新」をクリック
5. 「指定した通貨以外での支払い受け取りを拒否する。」項目の設定を「はい」に変更し、保存ボタンを押下

※あらかじめ「はい」が選択されている場合は、変更の必要はありません。
※「はい」以外が選択されている場合、日本円の残高にレート変換後の金額で入金されるケースや取引が保留状態になるケースが発生するため、必ず加盟店様にてご確認ください。

決済に利用したい通貨の登録

1. PayPal管理画面にログイン
2. 画面右上の事業者名から「アカウント設定」を選択
3. メニューから「資金、銀行およびカード」を選択
4. 通貨管理下の青字「通貨の追加」を選択

PayPal決済画面表示言語について

PayPal決済時にお客様が操作するPayPal決済画面の言語設定が可能です。

決済実行（ExecTranPaypal）リクエストパラメータ「言語」に指定可能な言語を設定してください。
表に存在しない言語を設定した場合、PayPal側にて対象なしとなり、英語で表示されます。また、パラメータに応じ表示される言語は、PayPalの仕様に拠ります。
存在しない言語コードにつきましては、PayPalへお問い合わせください。

　　　　

国名（言語）	国コード
英国	GB
日本	JP
中国	CN
ポーランド	PL
ベルギー	BE
フランス	FR
ドイツ	DE
スペイン	ES
スイス	CH
オーストリア	AT
オーストラリア	AU
オランダ	NL
イタリア	IT
アメリカ合衆国	US